home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / patches / patch2amitcp_4.3 / patch / amitcp / doc / inetd.doc < prev   
Encoding:
Text File  |  1996-03-30  |  6.1 KB  |  140 lines
  1.  
  2. inetd                         AmiTCP/IP Document                    inetd
  3.  
  4. NAME
  5.         inetd  -- internet ``super-server''
  6.  
  7. SYNOPSIS
  8.         inetd SERVPRI/K/N DEBUG/S CONFIGFILE
  9.  
  10. DESCRIPTION
  11.         inetd should be run when the AmiTCP/IP protocol stack is started.
  12.         inetd listens for connections on certain internet sockets.  When a
  13.         connection is found on one of its sockets, it decides what service
  14.         the socket corresponds to, and invokes a program to service the
  15.         request.  After the program is finished, it continues to listen on
  16.         the socket (except in some cases which will be described below).
  17.         Essentially, inetd allows running one daemon to invoke several
  18.         others, reducing load on the system.
  19.  
  20. PARAMETERS
  21.  
  22.         SERVPRI    
  23.                 Process priority for the launched servers.  Default is -1.
  24.  
  25.         DEBUG      
  26.                 Turns on debugging.
  27.  
  28.         CONFIGFILE 
  29.                 Specifies the configuration file name.
  30.  
  31. CONFIGURATION
  32.         Upon execution, inetd reads its configuration information from a
  33.         configuration file which, by default, is "db/inetd.conf".  There
  34.         must be an entry for each field of the configuration file, with
  35.         entries for each field separated by a tab or a space.  Comments are
  36.         denoted by a ``#'' at the beginning of a line or ``;'' anywhere in
  37.         the line.  There must be an entry for each field.  The fields of
  38.         the configuration file are as follows:
  39.  
  40.               service name
  41.               socket type
  42.               protocol
  43.               wait/nowait/dos/pri/stack
  44.               user
  45.               server program
  46.               server program name
  47.               server program arguments
  48.  
  49.         The service-name entry is the name of a valid service in the
  50.         netdatabase.  For ``internal'' services (discussed below), the
  51.         service name must be the official name of the service.
  52.  
  53.         The socket-type should be one of ``stream'', ``dgram'', ``raw'',
  54.         ``rdm'', or ``seqpacket'', depending on whether the socket is a
  55.         stream, datagram, raw, reliably delivered message, or sequenced
  56.         packet socket.  Current system supports only stream, datagram and
  57.         raw protocols.
  58.  
  59.         The protocol must be a valid protocol as given in netdatabase.
  60.         Examples might be ``tcp'' or ``udp''.
  61.  
  62.         The next entry specifies the type of server, its priority,
  63.         stacksize and other parameters.  The parameters are separated by a
  64.         slash (`/').  The available parameters are as follows:
  65.  
  66.         WAIT 
  67.                 If the server process all incoming connections or datagrams
  68.                 on a socket and eventually time out, the server is said to
  69.                 be ``single-threaded'' and should use a ``wait'' entry.
  70.                 Comsat and talkd are both examples of the this type of
  71.                 datagram server.
  72.  
  73.         NOWAIT 
  74.                 If a datagram server connects to its peer, freeing the
  75.                 socket so inetd can received further messages on the
  76.                 socket, it is said to be a ``multi-threaded'' server, and
  77.                 should use the ``nowait'' entry.  If a stream server
  78.                 handles only one connection, which is accepted by the
  79.                 inetd, it should also use the ``nowait'' entry.
  80.  
  81.         DOS
  82.                 If the server uses the DOS IO to handle the connection, it
  83.                 is called a ``naïve'' server, and it should use the ``dos''
  84.                 entry.  If the server is naïve, inetd maps a DOS filehandle
  85.                 to the incoming connection via TCP: handler (inet-handler).
  86.  
  87.  
  88.         STACK=nnnn
  89.                 The default stack size for servers is 16 kilobytes.  You
  90.                 can override the default with this parameter.  The minimum
  91.                 stack size is 4000 bytes.
  92.  
  93.         PRIORITY=p
  94.                 The task priority for servers is -10 by default.  You can
  95.                 override the default task priority for one server with this
  96.                 parameter.
  97.  
  98.  
  99.         The user entry should contain the user name of the user as whom the
  100.         server should run.  This field is for Unix and future compability
  101.         only.
  102.  
  103.         The server-program entry should contain the pathname of the program
  104.         which is to be executed by inetd when a request is found on its
  105.         socket.  If the server program is resident, the path name should be
  106.         suppressed.  If the server is naïve (ie. using DOS file IO), this
  107.         entry should contain the shell name or, if default user shell is to
  108.         be used, ``-''.  If inetd provides this service internally, this
  109.         entry should be ``internal''.
  110.  
  111.         The server-program-name is CLI command name for the server process.
  112.         It is shown in the printout of ``status'' command.  (Task name of
  113.         the server process is the service and the peer address, e.g. ``echo
  114.         [192.233.15.19]''.) This and argument entry are optional.
  115.  
  116.         The server program arguments should be just as arguments normally
  117.         are.
  118.  
  119.         inetd provides several ``trivial'' services internally by use of
  120.         routines within itself.  These services are ``echo'', ``discard'',
  121.         ``chargen'' (character generator), ``daytime'' (human readable
  122.         time), and ``time'' (machine readable time, in the form of the
  123.         number of seconds since mid­ night, January 1, 1900).  All of these
  124.         services are TCP and UDP based.  For details of these services,
  125.         consult the appropriate RFC from the Network Information Center.
  126.  
  127.         inetd rereads its configuration file automatically when the
  128.         configuration file is changed or when it receives the CTRL-F
  129.         signal.  Services may be added, deleted or modified when the
  130.         configuration file is reread.
  131.  
  132. HISTORY
  133.         Versions below 4 did not support Amiga DOS IO nor notifications.
  134.  
  135. BUGS
  136.         If the original configuration file is renamed and a new file is
  137.         created with old name, no file notification signals are sent.  In
  138.         that case you should either delete the old (now renamed) file or
  139.         send CTRL-F signal to inetd manually.
  140.